home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1993 / Internet Info CD-ROM (Walnut Creek) (1993).iso / inet / rfc / rfc811 < prev    next >
Encoding:
Text File  |  1991-04-20  |  7.6 KB  |  237 lines
  1.  
  2. Ken Harrenstien                                           RFC-811
  3. Vic White                                            1 March 1982
  4. Elizabeth Feinler
  5. Network Information Center
  6. SRI International
  7.  
  8.                         HOSTNAMES SERVER
  9.  
  10.  
  11.  
  12.  
  13. INTRODUCTION
  14.  
  15.    The NIC Internet Hostnames Server is an NCP/TCP-based host
  16.    information program and protocol running on the SRI-NIC
  17.    machine.  It is one of a series of ARPANET/Internet name
  18.    services maintained by the Network Information Center (NIC) at
  19.    SRI International on behalf of the Defense Communications
  20.    Agency (DCA).  The function of this particular server is to
  21.    deliver machine-readable name/address information describing
  22.    networks, gateways, hosts, and eventually domains, within the
  23.    internet environment.  As currently implemented, the server
  24.    provides the information outlined in the DoD Internet Host
  25.    Table Specification (RFC 810).
  26.  
  27. QUERY/RESPONSE FORMAT
  28.  
  29.    The name server accepts simple text query requests of the form
  30.  
  31.       <command key> <argument(s)> [<options>]
  32.  
  33.    where square brackets ("[]") indicate an optional field.  The
  34.    command key is a keyword indicating the nature of the request.
  35.    The defined keys are explained below.
  36.  
  37.    The response, on the other hand, is of the form
  38.  
  39.       <response key> : <rest of response>
  40.  
  41.    where <response key> is a keyword indicating the nature of the
  42.    response, and the rest of the response is interpreted in the
  43.    context of the key.
  44.  
  45. COMMAND/RESPONSE KEYS
  46.  
  47.    The currently defined keywords are:
  48.  
  49.       Command Keys:
  50.  
  51.          HNAME   (find entry with given name)
  52.          HADDR   (find entry with given address)
  53.          ALL     (return entire host table)
  54.          
  55.  
  56.  
  57.  
  58.                                                          [Page 1]
  59.  
  60.  
  61.                                                             1 March 1982
  62. RFC 811                                                 Hostnames Server
  63.                                                                         
  64.                                                                         
  65.       Response Keys:
  66.  
  67.          ERR     (entry not found, nature of error follows)
  68.          NET     (entry found, rest of entry follows)
  69.          GATEWAY (entry found, rest of entry follows)
  70.          HOST    (entry found, rest of entry follows)
  71.          BEGIN   (followed by multiple entries)
  72.          END     (done with BEGIN block of entries)
  73.  
  74.    More keywords will be added as new needs are recognized.  A
  75.    more detailed description of the allowed requests/responses
  76.    will follow.
  77.  
  78. PROTOCOL
  79.  
  80.    To access this server from a program, connect to service host
  81.    (SRI-NIC)
  82.  
  83.       TCP: port 101 decimal
  84.       NCP: socket 101 decimal for ICP
  85.  
  86.    send the information query, and await the response.
  87.  
  88.    Note:  Care should be taken to interpret the nature of the
  89.    reply (e.g, single record or multiple record), so that no
  90.    confusion about the state of the reply results.  An "ALL"
  91.    request will likely return several hundred or more records of
  92.    all types (see RFC 810), whereas "HNAME" or "HADDR" will
  93.    usually return one HOST record, or "BEGIN:", list of host
  94.    records, "END:", if there is more than one match.
  95.  
  96. QUERY/RESPONSE EXAMPLES
  97.  
  98.    1. HNAME Query - Given a name, find the entry or entries that
  99.    match
  100.       the name.  For example:
  101.  
  102.          HNAME SRI-NIC <CRLF>   ;where <CRLF> is a carriage
  103.       return/
  104.                                  linefeed, and 'SRI-NIC' is a
  105.       host name
  106.  
  107.       The likely response is:
  108.  
  109.          HOST : 10.0.0.73 : SRI-NIC,NIC : FOONLY-F3 : TENEX : NCP :
  110.  
  111.       A response may stretch across more than one line.
  112.       Continuation lines always begin with at least one space.
  113.       For example:
  114.  
  115.       HOST : 10.0.0.73 : SRI-NIC,NIC : FOONLY-F3 : TENEX : NCP :
  116.  
  117. [Page 2]
  118.  
  119.  
  120. 1 March 1982
  121. Hostnames Server                                           RFC 811
  122.                                                                         
  123.                                                                         
  124.                                                                         
  125.    2. HADDR Query - Given an internet address (as specified in
  126.    RFC
  127.       796) find the entry or entries that match that address.
  128.       For example:
  129.  
  130.          HADDR 10.0.0.73 <CRLF>   ;where <CRLF> is a carriage
  131.       return/
  132.                                    linefeed, and '10.0.0.73' is a
  133.       host
  134.                                    address
  135.  
  136.       The likely response is the same as for the HNAME request:
  137.  
  138.          HOST : 10.0.0.73 : SRI-NIC,NIC : FOONLY-F3 : TENEX : NCP :
  139.  
  140.  
  141.    3. ALL Query - Deliver the entire internet host table in a
  142.       machine-readable form.  For example:
  143.  
  144.          ALL <CRLF>   ;where <CRLF> is a carriage return/linefeed
  145.  
  146.       The likely response is the keyword 'BEGIN' followed by a
  147.       colon ':', followed by the entire internet host table in
  148.       the format specified in RFC 810, followed by 'END:'.  For
  149.       example:
  150.  
  151.          BEGIN:
  152.          NET : 10.0.0.0 : ARPANET :
  153.          NET : 18.0.0.0 : LCSNET :
  154.          GATEWAY : 10.0.0.77, 18.8.0.4 : MIT-GW :: MOS : IP/GW :
  155.          HOST : 10.0.0.73 : SRI-NIC,NIC : TENEX : FOONLY-F3
  156.             NCP/TELNET, NCP/FTP, TCP :
  157.          HOST : 10.2.0.11 : SU-TIP, FELT-TIP ::
  158.          END:
  159.  
  160. ERROR HANDLING
  161.  
  162.    1. ERR Reply - may occur on any query, and should be permitted
  163.    in
  164.       any access program using the name server.  Errors are of
  165.    the form
  166.  
  167.       ERR : <code> : <string> :
  168.  
  169.          as in
  170.  
  171.       ERR : NAMNFD : Name not found :
  172.  
  173.    
  174.  
  175.  
  176.                                                            [Page 3]
  177.  
  178.  
  179.                                                            1 March 1982
  180. RFC 811                                                Hostnames Server
  181.                                                                         
  182.                                                                         
  183.    The error code is a unique descriptor, limited to 8 characters
  184.    in length for any given error.  It may be used by the access
  185.    program to identify the error and, in some cases, to handle it
  186.    automatically.  The string is an accompanying message for a
  187.    given error for that case where the access program simply logs
  188.    the error message.  Current codes and their associated
  189.    interpretations are
  190.  
  191.       NAMNFD        --     Name not found; name not in table
  192.       ADRNFD        --     Address not found; address not in
  193.       table
  194.       ILLCOM        --     Illegal command; command key not
  195.       recognized
  196.       TMPSYS        --     Temporary system failure, try again
  197.       later
  198.  
  199. REMARKS
  200.  
  201.    The host name server described above runs over a single global
  202.    internet host name/address data base.  This data base is an
  203.    extension of the old ARPANET Hosts.txt file, and is being
  204.    maintained by the NIC to provide continuity during the
  205.    transition and expansion to the internet environment.  We view
  206.    the central administration of a global host name data base,
  207.    along with this simple name server, as an interim solution on
  208.    the way to a decentralized, distributed name/address
  209.    translation service.  The NIC welcomes your comments and
  210.    suggestions for such an expanded service.  Send comments to
  211.    NIC@SRI-NIC.
  212.  
  213. REFERENCES
  214.  
  215.    1. Feinler, E., Harrenstien, K., Su, Z. and White, V.
  216.    Official
  217.       DoD Internet Host Table Specification, RFC 810, Network
  218.       Information Center, SRI International, March 1, 1982.
  219.  
  220.    2. Postel, J.  Address Mappings, RFC 796, Information Sciences
  221.       Inst., Univ. of Southern Calif., Marina Del Rey, Sept.
  222.    1981.
  223.  
  224.    3. Pickens, J., Feinler, E., and Mathis, J.  The NIC Name
  225.    Server,
  226.       A Datagram-based Information Utility, Network Information
  227.       Center, SRI International, July 1979.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235. [Page 4]
  236.  
  237.